home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 12 C64 Telecom / KERM20.ARC / KERMIT1.DOC < prev    next >
Encoding:
Text File  |  2019-04-13  |  9.3 KB  |  289 lines
  1. Ç*NB"KERMIT 1.DOC"
  2. Ç*LM1:RM80
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                              ╦┼╥═╔╘-65 ╒╙┼╥╙ ╟╒╔─┼
  15.  
  16.                          ├OMMODORE 64 ╓ERSION 1.7(52)
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                                  ┼RIC ╠AVITSKY
  36.  
  37.                  ├ENTER ╞OR ├OMPUTER AND ╔NFORMATION ╙ERVICES
  38.                               ╥UTGERS ╒NIVERSITY
  39.                             ╨ISCATAWAY, ╬EW ╩ERSEY
  40.  
  41.                           ╘HIS ├OPY ╫AS ╨RODUCED ╧N:
  42.                         ╙UNDAY, 11 ┴UGUST 1985 AT 11:54
  43.                              ╒SING ╙CRIBE 4(1405)
  44. Ç*FP0
  45. ╔NTRODUCTION                                                             ╨AGE 1
  46.  
  47.  
  48. 1. ╔NTRODUCTION
  49.  
  50. 1.1. ╧VERVIEW
  51.  
  52. ┴UTHORS:    ─AVID ─ERMOTT, ─╥┼┴ 
  53.             ┼RIC ╠AVITSKY, ╥UTGERS ╒NIVERSITY 
  54.             ═ICHAEL ═ARCHIONDO, ╒NIVERSITY OF ╬EW ═EXICO 
  55.             ╞RANK ╨RINDLE, ╬AVAL ┴IR ─EVELOPMENT ├ENTER
  56. ─OCUMENTATION:
  57.             ┼RIC ╠AVITSKY, ╥UTGERS ╒NIVERSITY
  58. ╓ERSION:    1.7(52)
  59. ─ATE:       ┴UGUST 1985
  60.  
  61. ├-64 ╦ERMIT-65 ├APABILITIES ┴T ┴ ╟LANCE:
  62.  
  63.   ╠OCAL OPERATION:                   ┘ES
  64.   ╥EMOTE OPERATION:                  ┘ES
  65.   ╘RANSFERS TEXT FILES:              ┘ES
  66.   ╘RANSFERS BINARY FILES:            ┘ES
  67.   ╫ILDCARD SEND:                     ╬O
  68.   ^╪/^┘ INTERRUPTION:                ┘ES
  69.   ╞ILENAME COLLISION AVOIDANCE:      ┘ES
  70.   ├AN TIME OUT:                      ┘ES
  71.   8TH-BIT PREFIXING:                 ┘ES
  72.   ╥EPEAT COUNT PREFIXING:            ╬O
  73.   ┴LTERNATE BLOCK CHECKS:            ╬O
  74.   ╘ERMINAL EMULATION:                ┘ES
  75.   ├OMMUNICATION SETTINGS:            ┘ES
  76.   ╘RANSMIT ┬╥┼┴╦:                    ┘ES
  77.   ╔┬═ COMMUNICATION:                 ┘ES
  78.   ╘RANSACTION LOGGING:               ╬O
  79.   ╙ESSION LOGGING (RAW DOWNLOAD):    ╬O
  80.   ╥AW UPLOAD:                        ╬O
  81.   ┴CT AS SERVER:                     ╬O
  82.   ╘ALK TO SERVER:                    ┘ES
  83.   ┴DVANCED COMMANDS FOR SERVERS:     ╬O
  84.   ╠OCAL FILE MANAGEMENT:             ┘ES
  85.   ╚ANDLE FILE ATTRIBUTES:            ╬O
  86.   ├OMMAND/INIT FILES:                ┘ES
  87.   ╨RINTER CONTROL:                   ╬O
  88.  
  89. ╦┼╥═╔╘-65  IS  A  PROGRAM THAT IMPLEMENTS THE ╦┼╥═╔╘ FILE TRANSFER PROTOCOL FOR
  90. THE ├OMMODORE 64 MICRO COMPUTER SYSTEM. ╔T IS WRITTEN IN 6502 ASSEMBLY LANGUAGE
  91. AND  SHOULD  RUN  ON  ANY ├64. ╦┼╥═╔╘-65 ALSO ├ONVERTS YOUR ├64 INTO A POWERFUL
  92. COMPUTER TERMINAL. ╔T EMULATES THE POPULAR ─IGITAL ┼QUIPMENT  ├ORPORATION  ╓╘52
  93. TERMINAL  OR  A  SIMPLE  GLASS ╘╘┘.  ╘HE PROGRAM HANDLES ALL CONVERSION OF ├OM-
  94. MODORE TO STANDARD ┴╙├╔╔ AND CAN DISPLAY ALL 96 STANDARD ┴╙├╔╔ CHARACTERS.
  95. Ç*FP0
  96. ╨AGE 2                                                    ├64 ╦┼╥═╔╘ ╒SER ╟UIDE
  97.  
  98.  
  99. 1.2. ╙YSTEM ╥EQUIREMENTS
  100.  
  101. ╫HAT YOU WILL NEED:
  102.  
  103.    - ├64 AND ─ISK DRIVE
  104.    - ═ODEM - ANY WILL DO (300/1200, ╓╔├, ╥╙232)
  105.    - ╙UPERMON64.╓1 (OR ANY EQUIVALENT RELOCATABLE MONITOR)
  106. Ç*FP0
  107. ╔MPLEMENTATION ╬OTES                                                     ╨AGE 3
  108.  
  109.  
  110. 2. ╔MPLEMENTATION ╬OTES
  111.  
  112. 2.1. ╦NOWN ┬UGS, ╥ESTRICTIONS
  113.  
  114. ├64 ╦┼╥═╔╘-65 IS STILL UNDER DEVELOPMENT AND MAY HAVE SOME MINOR DEFFICIENCIES.
  115.  
  116. ╘HE KNOWN BUGS AND RESTRICTIONS ARE AS FOLLOWS:
  117.  
  118.    - ╘HE ╙┼╘ ┬┴╒─ OPTION IS NOT FULLY IMPLEMENTED. ╘O GET SPEEDS UNDER 300
  119.      BAUD,  YOU  WILL  HAVE  TO  SET THE ╥╙232-╥┼╟╔╙╘┼╥╙ DIRECTLY. ╙PECIAL
  120.      PATCHES TO THE ╦ERNEL ╥╙232 ROUTINES HAVE BEEN IMPLEMENTED  TO  ALLOW
  121.      RELIABLE  OPERATION AT 1200 BAUD. 1800 AND 2400 BAUD HAVE NOT BEEN SO
  122.      PATCHED.
  123.    - ╔F YOU CHANGE THE ╥╙232-╥┼╟╔╙╘┼╥╙ DIRECTLY, THE CHANGE  WILL  NOT  BE
  124.      REFLECTED IN THE ┬┴╒─, ╨┴╥╔╘┘, OR ╫╧╥─-╙╔┌┼ PARAMETERS.
  125.    - ╔F  A  ╦┼╥═╔╘.╔╬╔  FILE IS NOT PRESENT ON THE DISK, THE PARAMETERS IN
  126.      MEMORY GET GARBAGED TO AN UNUSABLE STATE AND MUST BE RESET BY HAND.
  127.    - ╘O CREATE A NEW ╦┼╥═╔╘.╔╬╔  FILE  WITH  THE  ╙┴╓┼  COMMAND,  THE  OLD
  128.      ╦┼╥═╔╘.╔╬╔  FILE  MUST  FIRST  BE  SCRATCHED  WITH THE ─╔╙╦ COMMAND :
  129.      (─╔╙╦ ╙0:╦┼╥═╔╘.╔╬╔).
  130.  
  131. 2.2. ╚╔╬╘╙
  132.  
  133. ╔F YOU WISH TO EDIT ┬┴╙╔├ PROGRAMS ON THE MAINFRAME SYSTEM, YOU SHOULD  CONVERT
  134. THEM TO TEXT FILES ON THE ├64 BEFORE YOU SEND THEM SINCE THE ┬┴╙╔├ INTERPRETERS
  135. STORE KEYWORDS AS SINGLE CHARACTER TOKENS. ╔F THE  RECEIVING  SYSTEM  DOES  NOT
  136. HANDLE  EIGHT-BIT ┴╙├╔╔ OR ├┬═ ┴╙├╔╔ CHARACTERS WELL, ╦┼╥═╔╘-65 SHOULD HAVE ITS
  137. ╞╔╠┼-┬┘╘┼-╙╔┌┼ SET TO ╙┼╓┼╬-┬╔╘. ╔T WILL SEND STANDARD SEVEN-BIT ┴╙├╔╔  TO  THE
  138. RECEIVING  ╦┼╥═╔╘.  ╫HEN  ╦┼╥═╔╘-65  IS RECEIVING FROM SUCH A SYSTEM, THIS WILL
  139. PICK UP THE SEVEN-BIT CHARACTERS AND WRITE OUT ├┬═ ┴╙├╔╔ ON THE DISK FILE.
  140.  
  141. 2.3. ╬OTES
  142.  
  143. ╨LEASE NOTE THAT TYPING A '^╪' (CONTROL-X) AT ANYTIME DURING A FILE TRANSACTION
  144. WILL QUIT THE CURRENT TRANSACTION, CLOSING THE CURRENT FILE. ╦ERMIT CAN ALSO BE
  145. FORCED TO 'TIMEOUT' BY TYPING A SPACE AT ANY POINT IN THE  TRANSACTION.  ╦ERMIT
  146. WILL THEN RESEND THE CURRENT PACKET.
  147.  
  148. 2.4. ╦┼╥═╔╘ ╥UNTIME ═EMORY ═AP
  149.  
  150. ╠OCATION    ─ESCRIPTION
  151. --------    ------------------------------------
  152.  
  153. $0801-$83FF ╦ERMIT PROGRAM AREA (╥ESERVED ┴REA)
  154. $8400-$87FF ╓IDEO MATRIX FOR BOTH 40 AND 80 COLUMN MODES
  155. $8800-$8FFF ├HARACTER SET 1 RAM FOR 40 COLUMN MODE
  156. $9000-$90FF ╥╙-232 OUTPUT BUFFER
  157. $9100-$91FF ╥╙-232 INPUT BUFFER
  158. $9200-$9FFF ╥ESERVED FOR FUTURE USE
  159. $A000-$BFFF ╚IRES SCREEN (80 COLUMNS)
  160. Ç*FP0
  161. ╨AGE 4                                                    ├64 ╦┼╥═╔╘ ╒SER ╟UIDE
  162.  
  163.  
  164. 2.5. ╞UTURE ╨LANS
  165.  
  166. ╘HE  FOLLOWING  ITEMS ARE UNDER CONSIDERATION FOR IMPLEMENTATION IN FUTURE VER-
  167. SIONS OF ╦ERMIT. ╨LEASE MAIL ANY COMMENTS OR SUGGESTIONS TO THE AUTHORS, OR IM-
  168. PLEMENT IT YOURSELF AND NOTIFY THE AUTHORS.
  169.  
  170.    1. ─ISK ROUTINES COULD BE CHANGED (╒SE ╘┴╠╦ ROUTINES INSTEAD OF ├╚╥╔╬)
  171.  
  172.    2. ├URSOR BLINK RATE IN PARSER MUST BE SLOWED DOWN
  173.  
  174.    3. ╞OR  SENDING  FILES, JIFFY WAIT SHOULD BE A FUNCTION OF CURRENT BAUD
  175.       RATE!
  176.  
  177.    4. ╔MPLEMENT 4 & 5 WITH A FLAG INDICATING CONNECT OR COMMAND MODE.
  178.  
  179.    5. ┴BILITY TO PAUSE DISPLAY IN PARSER (├┬═ KEY)
  180.  
  181.    6. ┴DD DISK COMMANDS:
  182.  
  183.                 ╦ERMIT-65>╙├╥┴╘├╚ FILE
  184.                 ╦ERMIT-65>╥┼╬┴═┼ NEWFILE=OLDFILE
  185.  
  186.    7. ├HANGE STATUS DISPLAY SCHEME FOR TRANSFER:
  187.  
  188.        -----------------------------------------------------------------
  189.  
  190.               ╨ACKETS: 0                 ╙TATUS...
  191.               ╥ETRIES: 0
  192.               ╞ILENAME: ╞╔╠┼╬┴═┼.┼╪╘
  193.  
  194.        -----------------------------------------------------------------
  195.  
  196.               ╨ACKETS: 0                 ╙TATUS...
  197.               ╥ETRIES: 0
  198.               ╞ILENAME: ╞╔╠┼╬┴═┼.┼╪╘
  199.  
  200.               ┴DDITIONAL ─ATA
  201.                       ╙EQ ╬UMBER              00
  202.                       ╬UMBER ╧F ─ATA ├HARS    00
  203.                       ╨ACKET ├HECKSUM         00
  204.  
  205.        -----------------------------------------------------------------
  206.  
  207.               ETC., ETC... SOMETHING LIKE THIS ANYWAY - ╘HE SCREEN
  208.               SHOULDN'T CONSTANTLY BE CLEARED AND REDRAWN. ┴LL PERTINENT
  209.               FIELDS SHOULD BE WRITTEN ONCE AND THEN UPDATED AS
  210.               NECESSARY.
  211.  
  212.               ╔MPLEMENT USING PLOT FUNCTION TO MOVE CURSOR TO CORRECT
  213.               POSITION. ╞OR ╓ERBOSE DEBUG, DISPLAY PACKET INFO TWO LINES
  214.               BENEATH FILENAME.
  215. Ç*FP0
  216. ╔MPLEMENTATION ╬OTES                                                     ╨AGE 5
  217.  
  218.  
  219.        -----------------------------------------------------------------
  220.  
  221.    8. ┴BILITY TO CHANGE SCREEN COLORS:
  222.  
  223.                           ╦ERMIT-65>╙┼╘ ├╧╠╧╥ NN
  224.  
  225.  
  226.    9. ┴DD CAPABILITY OF SELECTING DEFAULT DRIVE AND UNIT NUMBER FOR TRANS-
  227.       FER.
  228.  
  229.   10. ╔MPLEMENT WILDCARD SEND - NEED INFO ON 1541 ─╧╙ FOR THIS!
  230.  
  231.   11. ─ISK COMMAND PARSING SHOULD USE ├═╒╬╤╙ (UNQUOTED STRING) PARSE.
  232. Ç*FP0
  233. ╨AGE 6                                                    ├64 ╦┼╥═╔╘ ╒SER ╟UIDE
  234.  
  235.  
  236. 3. ╥UNNING ╦┼╥═╔╘
  237.  
  238. 3.1. ┬OOTING ╦┼╥═╔╘
  239.  
  240. ╔NSERT YOUR WORKING ╦┼╥═╔╘-65 DISK INTO THE 1541 DRIVE LABEL SIDE UP.  ╘YPE THE
  241. FOLLOWING:
  242.  
  243.         ╠╧┴─"╦┼╥═╔╘",8 <CR>
  244.         ╥╒╬ <CR>
  245.  
  246. ╘HE SCREEN WILL COME UP WITH THE FOLLOWING MESSAGE:
  247.  
  248.             ├OMMODORE 64 ╦ERMIT ╓ERSION 1.7(52)
  249.             40 ├OLUMN ═ODE - ? ╞OR ╚ELP
  250.  
  251.             ╦ERMIT-65>
  252.  
  253.  
  254. ┘OU ARE NOW IN THE ╦┼╥═╔╘-65 PARSER WHICH IS MODELED AFTER THE ├╧═╬─ PARSER  OF
  255. THE  ╘╧╨╙-20  ╧PERATING  ╙YSTEM FROM ─IGITAL ┼QUIPMENT ├ORPORATION. ┘OU MAY NOW
  256. TYPE COMMANDS TO THE PARSER TO SET OPTIONS OR BEGIN ACTIONS.
  257.  
  258. ─URING INTERACTIVE OPERATION, YOU MAY USE THE ?-PROMPTING  HELP  FEATURE  ("?")
  259. AND  RECOGNITION  (┼╙├)  FEATURES  WHILE  TYPING COMMANDS (╘HE ┼╙├ CHARACTER IS
  260. PRESENTLY ^[ - CONTROL ╠EFT ┬RACKET OR THE LEFT ARROW KEY).   ┴  QUESTION  MARK
  261. TYPED  AT  ANY POINT IN A COMMAND DISPLAYS THE OPTIONS AVAILABLE AT THAT POINT;
  262. TYPING AN ┼╙├ CHARACTER CAUSES THE CURRENT KEYWORD TO BE COMPLETED (OR  DEFAULT
  263. VALUE TO BE SUPPLIED).  ╔F YOU HAVE NOT TYPED SUFFICIENT CHARACTERS TO UNIQUELY
  264. SPECIFY THE KEYWORD OR FILENAME (OR IF THERE IS NO DEFAULT VALUE) THEN  A  BEEP
  265. WILL  BE  SOUNDED  AND YOU MAY CONTINUE TYPING.  ╦EYWORDS MAY BE ABBREVIATED TO
  266. ANY PREFIX THAT IS UNIQUE.
  267.  
  268. 3.2. ├OMMANDS IN ╦┼╥═╔╘
  269.  
  270. ├OMMANDS AVAILABLE IN VERSION 1.7 OF ╦ERMIT-65 ARE:
  271.  
  272.             ┬┘┼         ├╧╬╬┼├╘     ─╔╥┼├╘╧╥┘   ─╔╙╦        ┼╪╔╘        ╞╔╬╔╙╚
  273.             ╟┼╘         ╤╒╔╘        ╥┼├┼╔╓┼     ╥┼╙╘╧╥┼     ╙┴╓┼        ╙┼╬─
  274.             ╙┼╘         ╙╚╧╫        ╙╘┴╘╒╙
  275.  
  276. ┬┘┼
  277.                 ╘HIS  COMMAND  WILL  CAUSE ╦ERMIT-65 TO TELL A SERVER ╦ERMIT AT
  278.                 THE OTHER END OF THE CONNECTION TO EXIT FROM ╦ERMIT AND, IF AP-
  279.                 PLICABLE, TERMINATE ITS JOB (OR PROCESS, ETC.).
  280.  
  281.  
  282.                                  ╦┼╥═╔╘-65>┬┘┼
  283.  
  284. ├╧╬╬┼├╘
  285.                 ╘HE ├╧╬╬┼├╘ COMMAND WILL ALLOW YOU TO CONNECT TO A  REMOTE  JOB
  286.                 OVER THE TERMINAL LINE AS A VIRTUAL TERMINAL. ╘HE FORMAT OF THE
  287.                 ├╧╬╬┼├╘ COMMAND IS:
  288. Ç*LK:KERMIT 2.DOC
  289.